1. HuNI team Avatar HuNI team
  2. HuNI
  3. documentation

Wiki

Clone wiki

documentation / Data Model / Entity Details - Person

View History

Entity Details - Person

ID

Field: ID

Field Type: Unique Key

Cardinality: Exactly 1 and unique

Semantics of this field: This is a unique key which uniquely identifies the person within HuNI. Note that matching person entities is part of the HuNI matching process, so two identifiers may possibly point to the same person.

Other Notes: Generated by HuNI

Source

Field: Source

Cardinality: 0..n

Semantics of this field: Source of info provided to this record eg ADB, AFIRC. Should include all sources that have contributed to the record.

Source Identifier

Field: Source Identifier

Cardinality: 0..n

Semantics of this field: Identifier used for this person by the original source, eg the People Australia identifier used by ADB and OA), NLA etc. Goes with the source.

Gender

Field: Gender

Field Type: Limited Values - MALE, FEMALE, OTHER

Cardinality: 0 or 1

Example: "FEMALE"

Semantics of this field: This is the person's gender as classified at birth. (We may consider adding another field to accommodate gender changes later in life if needed in the future, but this has not been identified as a current need).

If unknown, leave blank.

Other Notes: Leave blank if unknown.

Nationality

Field: Nationality

Cardinality: 0..n

Semantics of this field: Person's Nationality. May be more than one if they have had different nationalities at different times, or have dual/multiple citizenship.

List of countries to be provided. Need to consider temporal aspects - some nationalities may no longer be current, but still need to be available.

Cultural Heritage

Field: Cultural Heritage

Cardinality: 0..n

Semantics of this field: Person's Cultural Heritage.

Indigenous Australian

Field: Indigenous Australian

Field Type: Binary - Y / N

Cardinality: 0..1

Semantics of this field: Set to Y if the person may be considered to be indigenous. Set to N only if definitely not indigenous, else leave blank.

Religious Affiliation

Field: Religious Affiliation

Field Type: From List and text

Cardinality: 0..n

Semantics of this field: Person's Religion, spirituality, etc

Name

Field: Name

Cardinality: 0..n

Semantics of this field: (If it can't be decomposed reliably, whole string goes in here at top element)

Primary Name

Field: Name

Subfield: Primary Name

Field Type: Binary - Y / N

Cardinality: 0..1

Semantics of this field: Set to Y if this name entry should be considered the primary name entry. Generally the primary name is simply the one most widely recognised. Doesn't have to be any specific type of name.

Title

Field: Name

Subfield: Title

Field Type: String

Cardinality: 0..n

Example: Dr

Semantics of this field: Title

Family

Field: Name

Subfield: Family

Field Type: String

Cardinality: 0..n

Example: Bradley

Semantics of this field: This is the person's family name. In Western naming traditions it is usually the surname. There may be more than one, reflecting different family names used during an individual's lifetime.

Names may have temporal boundaries.

Individual

Field: Name

Subfield: Individual

Field Type: String

Cardinality: 0..n

Example: Joan, Burton

Semantics of this field: This is the person's individual names (In Western naming traditions usually the forenames). There may be more than one - give in correct order

Other notes: May need ordering when more than one and they are ordered

Initials

Field: Name

Subfield: Initials

Field Type: String

Cardinality: 0..1

Semantics of this field: Use this field if individual names are unknown and only initial(s) are known

Nickname

Field: Name

Subfield: Nickname

Field Type: String

Cardinality: 0..1

Semantics of this field: Use this field to record a nickname. Should be recorded as a separate name entry, not with the other name fields.

Name Type

Field: Name

Subfield: Name Type

Field Type: Pre-defined list

Cardinality: 0..1

Semantics of this field: Indicate whether this name is:

  • Birth Name
  • Married Name
  • Stage Name
  • Nickname
  • etc

Start Date

Field: Name

Subfield: Start Date

Field Type: Date

Cardinality: 0..1

Semantics of this field: Earliest date from which this name applied to person

End Date

Field: Name

Subfield: End Date

Field Type: Date

Cardinality: 0..1

Semantics of this field: Latest date at which this name applied to person

Birth Date

Field: Birth Date

Field Type: Date

Cardinality: 0..1

Semantics of this field: This is the person's date of birth formulated as a standard date. It should show the local time where the person was born.

May not be known to the day, so needs to accommodate imprecision eg just the month and year, just the year, just the decade, a date range.

Death Date

Field: Death Date

Field Type: Date

Cardinality: 0..1

Semantics of this field: This is the person's date of death, if deceased.

May not be known to the day, so needs to accommodate imprecision eg just the month and year, just the year, just the decade, a date range.

Flourished from

Field: Flourished from

Field Type: 4 digit year

Cardinality: 0..1

Semantics of this field: Year person flourished from - relevant for creatives

Flourished to

Field: Flourished to

Field Type: 4 digit year

Cardinality: 0..1

Semantics of this field: Year person flourished to - relevant for creatives

Description

Biography

Field: Description

Subfield: Biography

Field Type: Text

Cardinality: 0..n

Semantics of this field: Free text biography.

Abstract

Field: Description

Subfield: Abstract

Field Type: Text

Cardinality: 0..n

Semantics of this field: Free text short description.

Obituary

Field: Description

Subfield: Obituary

Field Type: Text

Cardinality: 0..n

Semantics of this field: Free text obituary.

Person Type

Occupation

Field: Person Type

Subfield: Occupation

Field Type: Text

Cardinality: 0..n

Semantics of this field: Person's occupation: initially this is just text of whatever is provided by the source. In future phases we may decompose this further and categorise.

Field Citation

For each field we need to cite:

Field: URL Link to Data Source

Field type: URL

Semantics of this field: Link to the relevant information in the original data source

Data Source

Field: Data Source

Field type: String

Semantics of this field: Where the information comes from: may be * Name of initial data source eg ADB OR * HuNI Match OR * User generated by user XXX

Date harvested

Field: Date harvested

Field type: Date

Semantics of this field: Date the record was harvested from the original Data Source This is for internal purposes, doesn't need to be displayed to users.

Current as of Date

Field: Current as of Date

Field type: Date

Semantics of this field: Date the information was last known to be created/changed in the original source

Notes: will be able to specify a group of Persons and relate them to individual People in the group

Relations to other Entities

Birth Place

Relation: Birth Place

to Entity: Place

Details: Inverses:

PERSON hasPlaceofBirth PLACE

PLACE isBirthPlaceOf PERSON

Cardinality: 0..1 (0..n for inverse)

Semantics of this field: Place where person was born

Death Place

Relation: Death Place

to Entity: Place

Details: Inverses:

PERSON hasPlaceofDeath PLACE

PLACE isDeathPlaceOf PERSON

Cardinality: 0..1 (0..n for inverse)

Semantics of this field: Place where person died

Same As

Relation: Same As

to Entity: Person

Details: Reflexive (ie inverse is the same)

Cardinality: 0..n

Semantics of this field: Assert that this Person record refers to the same Person as another Person record

Associated With

Relation: Associated With

to Entity: Person, Concept, Place

Details: Reflexive (ie inverse is the same)

Cardinality: 0..n

Semantics of this field: Associate the Person with another Person, Concept or Place

Family relationship with

Relation: Family relationship with

to Entity: Person

Details: Reflexive (ie inverse is the same)

Cardinality: 0..n

Semantics of this field: Assert a family relationship between two people (this will have specific sub-properties for specific relationships eg Father of, Spouse of etc)

Has Role In

Relation: Has Role In

to Entity: Organisation, Event

Cardinality: 0..n

Semantics of this field: Assert a person is a member of a group

Updated